home *** CD-ROM | disk | FTP | other *** search
/ Software 2000 / Software 2000 Volume 1 (Disc 1 of 2).iso / utilities / u321.dms / in.adf / Icontools.doc < prev    next >
Encoding:
Text File  |  1993-11-08  |  6.3 KB  |  147 lines
  1.                            ICONTOOLS  Documentation
  2.                            
  3.                               by  Enrique Gamez
  4.                               
  5.    This file was written to supplement the sketchy instructions which
  6.    usually accompany public domain software.  I use a reference card format
  7.    below for clarity.
  8.    
  9.    
  10.    IconTool:  ALTICON (AKA SetALternate)
  11.    
  12.    Usage (from CLI):  SetAlternate  Icon1  Icon2
  13.    
  14.    Purpose:  This tool merges the graphic information of Icon2 into Icon1. 
  15.    The resulting icon will appear just as it did before UNTIL you click on
  16.    it (select it with the mouse.)  At that point, the image will change to
  17.    that contained in icon2.  The neat thing about this is that you can
  18.    create pseudo 2-step animation if the two images differ only slightly. 
  19.    Of course, they could differ entirely if you wish.
  20.    
  21.    Note:  The original Icon1 image once merged with SetAlternate can no
  22.    longer be accessed by the Icon Editor.  So, save a copy under a
  23.    different name if you're going to experiment a bit.
  24.    ---------------------------------------------------------------------
  25.  
  26.    IconTool:  Brush2Icon
  27.  
  28.    Alias (also seen as):  Zapicon
  29.  
  30.    Usage (from CLI):  Brush2Icon  BrushName  IconName
  31.  
  32.    Purpose:  This tool converts an image from Deluxe Paint saved as a
  33.    brush (or an image from Aegis Images saved as a window) to a work-
  34.    bench icon definition.  It will even add the ".info" suffix to the
  35.    filename you specify.  I gave you the file with the original title
  36.    Zapicon, but it may be worth renaming it to its alias as seen above.
  37.    Brush2Icon is a much more descriptive title which will help you re-
  38.    member its function.
  39.       There are some restrictions you'll encounter with using a graphic
  40.    package to create your icons.  At first it will seem as if you now
  41.    can do anything...but... 1)  You can only use the first four colors
  42.    in the palette; 2)  Your resulting icon's demensions may be distorted
  43.    depending on whether you normally use a 640 pixel workbench screen or
  44.    the 320 pixel/60 char screen.  See the chart below:
  45.  
  46.                DPaint     Height     Width
  47.               -----------------------------
  48.                lo-res  |    1x        .5x
  49.               med-res  |    1x         1x
  50.                hi-res  |    2x         1x
  51.  
  52.    Assuming a 640x200, 80 char workbench screen the above table compares
  53.    the relative dimensions of a saved brush to that of the icon it will
  54.    become.  As you can see, in medium resolution there is a 1 to 1 cor-
  55.    respondence, i.e. WYSIWYG (What You See Is What You Get).  If a brush
  56.    is saved from the hi-res mode of DPaint it will turn out twice as tall.
  57.    It is possible to load your newly created icons into IconEd and play
  58.    with them some more.  However, I occassionally found some garbage in
  59.    the picture which I simply cleaned up, one pixel at a time.
  60.    ----------------------------------------------------------------------
  61.  
  62.    IconTool:  Xicon 
  63.  
  64.    Alias (also seen as):  it can appear as anything! 
  65.  
  66.    Usage:  Use as a tool invoked by an attached icon (see below).
  67.  
  68.    Purpose:  This utility is the missing link we workbench users have
  69.    been waiting for.  It allows us to execute CLI commands from the work-
  70.    bench.  Our tool icons should eventually be able to do this.  In the
  71.    meantime, John Toebes the author, has provided a clever work-around.
  72.  
  73.    Tutorial:  First, duplicate any tool icon like IconEd or the Clock.
  74.    We're going to attach it to IconExe.  Let's say for example that our
  75.    program will be called "DIRECTORY".  We are going to attempt a "DIR"
  76.    command from a workbench icon.  If everything is in your root direc-
  77.    tory, type
  78.  
  79.    1> RENAME Xicon.info DIRECTORY.info
  80.    1> RENAME Xicon DIRECTORY
  81.  
  82.    you have now attached an icon to a tool.  Now, go to the workbench and
  83.    double-click the disk icon to reveal the copied icon.  You could and
  84.    should, of course, create an original icon for this new utility so as
  85.    not to confuse its intended function.  You may now select your icon
  86.    (single click) and go to the pull down workbench menu and choose INFO.
  87.    This is the configuration menu which allows us to add the commands we
  88.    wish executed.  IconExe comes with its TOOL TYPES array empty, however
  89.    you can certainly edit an old copy of Xicon with the ADD and DEL
  90.    gadget buttons to take on a different job.  Since ours is empty, click
  91.    on the ADD box once then click again within the rectangular area just
  92.    to its left.  At the cursor, type
  93.  
  94.    DIR
  95.  
  96.    and press return.  Now save this array of 1 element back to your disk
  97.    by clicking on the SAVE button on the lower left of the INFO screen.
  98.    If your disk has a "DIR" command in the "c" directory, double-clicking
  99.    on the DIRECTORY icon should work.
  100.       Unfortunately, you may notice that the directory although it works
  101.    fine, goes away as soon as it is through without giving you time to
  102.    read it.  Let's add an element to the TOOL TYPES array.
  103.       Go back to the INFO screen and click on the ADD button (the list
  104.    of elements scrolls, revealing the next space) then just left of it
  105.    as before.  This time, type
  106.  
  107.    WAIT 5
  108.  
  109.    and press return.  This should give you 5 seconds to view the direc-
  110.    tory before it disappears.  More importantly, it gives you time to
  111.    press the right, menu button so you can further freeze the display
  112.    as long as you wish.
  113.       Read the description of the SetWindow icon tool to further custo-
  114.    mize the IconExec utility.
  115.  
  116.    NOTES:  The commands you may execute are looked for in the "c" and
  117.    root directories.  The "CD" or current directory doesn't seem to make
  118.    any difference.  If you want to run a command residing in a different
  119.    directory or disk you must include the path within the TOOL TYPES
  120.    requester, thus
  121.  
  122.    UTILITIES/CALCULATOR
  123.  
  124.    is needed if you wanted to run the calculator.  Use a specific disk
  125.    name like the one I used for our PD disk,
  126.  
  127.    SFVAUG.86.08:___________ etc.
  128.  
  129.    so it can work from any drive.  Optionally, you may just use,
  130.  
  131.    DF1:_____________ etc.
  132.  
  133.    That's all for now...
  134.    ---------------------------------------------------------------------
  135.  
  136.  
  137.    Bye for now, ...  Enrique Gamez, SFVAUG.86.08
  138.  
  139.    This file originally appeared in the August 1986 Public Domain Disk as
  140.    distributed to the members of our Amiga Club:
  141.  
  142.                     San Fernando Valley Amiga User's Group
  143.                               (818) 344-2055
  144.               
  145.     
  146.  
  147.